home *** CD-ROM | disk | FTP | other *** search
/ Express Pd: GALORE / Express Pd Galore - The Amiga PD & Shareware CD (1994)(Express Pd)[!][Amiga-CD32-CDTV].iso / productivity / videomaxe433 / docs / manual.txt < prev    next >
Text File  |  1994-05-01  |  46KB  |  1,105 lines
  1. Document VideoMaxe Manual
  2.  
  3.                         VideoMaxe Manual
  4.                        ~~~~~~~~~~~~~~~~~~
  5.          VideoMaxe Release 04.33 © Stephan Sürken 1994
  6.  
  7.                      Closed on 01 May 1994
  8.  
  9.  (E) This "VideoMaxe Manual" is in english, but the "VideoMaxe
  10.  Documentation" may be available in different languages. Try `Documentation'.
  11.  
  12.  (D) Dieses "VideoMaxe Handbuch" ist in Englisch, aber die "VideoMaxe
  13.  Dokumentation" ist (bald) auch in Deutsch verfügbar. Siehe `Documentation'.
  14.  
  15.  ##########################################################################
  16.  # The complete release documentation includes any "README" files in the  #
  17.  # main directory and the following files:                                #
  18.  #                                                                        #
  19.  #-o Docs/Manual.txt          (Docs/Manual.guide, respectively)           #
  20.  #                                                                        #
  21.  #     This file. Includes often changing/environmental informations and  #
  22.  #     is therefore in English only.                                      #
  23.  #                                                                        #
  24.  #-o Docs/Documentation_X.txt (Docs/Documentation_X.guide, respectively)  #
  25.  #                                                                        #
  26.  #     The proper documentation. X stands for an abbreviation for a       #
  27.  #     language (e.g.: X=E => language=English, X=D => language=Deutsch). #
  28.  #     These guide files can be used as online help files in VideoMaxe.   #
  29.  ##########################################################################
  30.  
  31.  
  32. 0. Important
  33. =============
  34.  
  35. 0.1. Copyright & legal stuff
  36. -----------------------------
  37.  
  38.  All releases of VideoMaxe are (c) Copyright Stephan Sürken 1989-94.
  39.  All versions of VMConvert are (c) Copyright Stephan Sürken 1992-93.
  40.  
  41.   The whole package is SHAREWARE, that means you may distribute it
  42.  freely (if you stick to the terms below) but if you really USE it,
  43.  you must send me a donation for registration. A registration
  44.  is valid for all VideoMaxe releases with the same 'main-version'
  45.  (currently 4); that means if you register now, you have the right
  46.  to get all updates + passwords for all releases up to version
  47.  number 04.99. Practically (as I fear I won't find so many improvements
  48.  to justify a main version 5) your registration will be valid unlimited...
  49.   Without the password, you will not be able to create own mask
  50.  entry lists (but you can use the delivered examples) and some
  51.  nerving requesters will show up now and then. However, even
  52.  without the password you can work properly with VideoMaxe -- but
  53.  _please_ don't forget to register if you really like it :-).
  54.   Registered users will be informed of major updates (e.g.
  55.  from 04.10 to 04.20).
  56.  
  57.                    See `How to register'.
  58.  
  59.  
  60.   IF YOU DISTRIBUTE VideoMaxe, you MUST copy the whole original archive.
  61.  Exceptions:
  62.   o You may leave out the foreign software packages (see below) --
  63.     but if you do so, you must include a new, own README file that
  64.     says what changes you did to the archive.
  65.   o You may freely distribute separately both documentation files
  66.     "VideoMaxe.doc" or "VideoMaxe.guide" if you let them unchanged.
  67.  
  68.   IF YOU DISTRIBUTE VideoMaxe you MUST NOT demand more than your costs
  69.  have been to copy it. Especially, you MUST NOT sell it for more than
  70.  five (5) US Dollar or five (5) DM (or an equivalent in other currencies).
  71.  This limit is obligatory for all Public Domain dealers.
  72.  
  73.   The program may be included in Public Domain Series, especially in
  74.  Fred Fishs Amiga Disk Library.
  75.  
  76.   The program may in no way whatsoever be used commercially without
  77.  the author's permission.
  78.  
  79.   However, I am not responsible for any damages this program might do.
  80.  Though it is tested thoroughly, I can't guarantee that the program
  81.  will perform exactly as decribed.
  82.  
  83.   The program must neither be used nor copied by any extremely right wing
  84.  organisations or persons.
  85.  
  86.  
  87.                        Foreign software products
  88.                        ~~~~~~~~~~~~~~~~~~~~~~~~~
  89.  (1) The Installer software (c)Commodore
  90.  
  91.   You need the installer to run the multi-purpose VideoMaxe installation
  92.  script. It comes with the original OS 2.1+ distribution and is located
  93.  on the "Install" disk. You have to copy that program "Installer" from
  94.  the "Install" disk to your "c:" directory.
  95.  
  96.  (2) The AmigaGuide software (c)Commodore
  97.  
  98.   The two files 'AmigaGuide' (& its icon) and 'amigaguide.library'
  99.  are included in this archive in the 'Tools' directory. Please note:
  100.  
  101.    AmigaGuide, AmigaGuide.info, amigaguide.library, WDisplay, WDisplay.info
  102.    (c) Copyright 1991-93 Commodore-Amiga, Inc.  All Rights Reserved.
  103.    Reproduced and distributed under license from Commodore.
  104.  
  105.    AMIGAGUIDE SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  106.    NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  107.    OR RESPONSIBILITY IS ASSUMED.
  108.  
  109.   To install the AmigaGuide, simply copy 'amigaguide.library' to your
  110.  'libs:' directory and 'AmigaGuide' to your 'SYS:Utilities' directories,
  111.  which is the recommended installation. For both files please check
  112.  first if you haven't got a more recent version already installed!
  113.  
  114.   You need 'AmigaGuide' to view the doc files 'XXX.guide' and the
  115.  'amigaguide.library' to be able to use its features with VideoMaxe
  116.  (which is not yet supported [433-]...).
  117.  
  118.  
  119. 0.2. Release Notes
  120. -------------------
  121.  
  122.  VideoMaxe 04.33, © Stephan Sürken.
  123.  Needs VideoMaxe.catalog 6.
  124.  
  125.  Please read the file "ThisRelease.txt" in the release directory.
  126.  See `Bugs' and `Changes' for innovations.
  127.  
  128.  Compiled with M2Amiga, Release 4.2.
  129.  Program is reentrant, creates a min stack of 20000 Byte automatically.
  130.  A needed but not existing library causes an program assertion with
  131.  an "Arts" error message.
  132.  All run time checks are off to make the program fast - so, unfortuneately
  133.  some (unknown) bugs could lead to a system crash instead of a fine
  134.  M2Amiga assert message.
  135.  
  136.  Special compilations for better CPUs possible if requested.
  137.  
  138. 0.3. How to register
  139. ---------------------
  140.  
  141.  Lesen Sie auch die Datei "LiesMich.txt" für Registrierung!!
  142.  
  143.   Note that any earnest usage of VideoMaxe leads to the necessity to
  144.  register. Especially, you MUST NOT use the 'limited' VideoMaxe without
  145.  registration longer than one month.
  146.  
  147.   You can register and thus obtain the password by sending me a
  148.  shareware donation of
  149.  
  150.        30,- Deutsche Mark        or        20,- US Dollar
  151.  
  152.  or an equivalence in other currencies.
  153.  
  154.  Practically, the procedure should be like this:
  155.  
  156.  1st: Contact me, indicating that you want to register. Tell me your
  157.       full name & address & what version of VideoMaxe you use.
  158.       E-Mail appreciated.
  159.  2nd: Transmit the money, in what way ever you think it's appropriate
  160.       (cash in snail mail, transfer to my bank account, cheque, etc.).
  161.       Please identify yourself sufficiently, so that I can find out who
  162.       sent me the money...
  163.  
  164.  Certainly, you may combine 1st & 2nd, e.g. in one snail mail...
  165.  
  166.  If you have done so, you are a registered user. I will then contact you
  167.  & give you the password(s).
  168.  
  169.  NOTE that you will not get an update then. See `How to get updates'.
  170.  
  171.  Certainly, you may combine registering & getting an update, e.g. in one
  172.  snail mail...
  173.  
  174.  See `The Author'                   for addresses.
  175.  
  176.  See `Copyright & legal stuff'      for your rights & advantages as
  177.                                     registered user.
  178.  See `Documentation'                for how to employ the password.
  179.  
  180.  
  181. 0.4. How to get updates
  182. ------------------------
  183.  
  184.  Lesen Sie auch die Datei "LiesMich.txt" für Updates!!
  185.  
  186.  There are two ways to get an update of VideoMaxe:
  187.  
  188.  o Look out for PD Series or any other place were PD resp. ShareWare
  189.    is open for the public.
  190.    Hints: I will always upload the newest version to the _AmiNet_.
  191.           I will always ask A.P.S. to include the newest version on a
  192.           _TIME_ PD disk.
  193.           I will always ask Fred to include the newest version on a
  194.           _Fish_ PD disk.
  195.  
  196.  o Send to me via snail mail:
  197.    - A disk (3.5" DD)
  198.    - an sufficiently stamped return-envelope (international answering
  199.      formular appreciated; innerhalb Deutschlands 2,- DM Porto)
  200.    - 10,- DM/Dollar (for my endeavour)
  201.  
  202.   [- 30,- DM/20,- Dollar additionally, ONLY if you simultaneously want to]
  203.   [  register. See `How to register'.                                    ]
  204.  
  205.    I will the return the return-envelope with the newest version.
  206.  
  207.  
  208. 0.5. Rise from VideoMaxe 03.XX to 04.XX
  209. ----------------------------------------
  210.  
  211.   If you have used VideoMaxe 03.XX, you can update your project and
  212.  your "Treiber"-files. This is done by the CLI-tool "VMConvert",
  213.  residing in the "Tools" directory of the original archive.
  214.  It can convert VideoMaxe 03.XX projects and VideoMaxe 03.XX
  215.  "Treiber"-files to the current format.
  216.  
  217.  Do this conversions with the multiple use installer script
  218.  "InstallVM" in the original archive. Please start this up and
  219.  read its help texts for details.
  220.  
  221.  Refer to VMConvert`s documentation (if existing) if you want to
  222.  use it from Shell ("VMConvert ?" will show up the syntax).
  223.  
  224. 0.6. Rise from VideoMaxe 04.20 to 04.30
  225. ----------------------------------------
  226.  
  227.   If you have used VideoMaxe 04.00-04.20, you can update your mask list,
  228.  project, video recorder and printer preferences files. VideoMaxe
  229.  preferences files cannot be updated and layout preferences files
  230.  haven't changed their format.
  231.  
  232.   The conversion is done by the CLI-tool "VMConvert",
  233.  residing in the "Tools" directory of the original archive.
  234.  
  235.  Do this conversions with the multiple use installer script
  236.  "InstallVM" in the original archive. Please start this up and
  237.  read its help texts for details.
  238.  
  239.  Refer to VMConvert`s documentation (if existing) if you want to
  240.  use it from Shell ("VMConvert ?" will show up the syntax).
  241.  
  242. 0.7. Odds & Ends
  243. -----------------
  244.  
  245.  o locale.library 38.24 (31.3.92)
  246.    I used that library while coding the localization of VideoMaxe and
  247.    I nearly got mad (thinking I would do sth wrong) as the oc_version
  248.    tag in its opening procedure (which asures you that the right catalog
  249.    version is opened) would not work. I did help myself out by storing
  250.    the catalog version as a string the iff catalog files themselves.
  251.     When I got version 38.27 of the library, it DID work, and so I
  252.    dropped that special version check since VideoMaxe 04.31+. So if you
  253.    should have problems opening your language catalog, be sure to use the
  254.    locale library 38.27 or better.
  255.     Note: Stefan Becker's "Toolmanager" had exactly the same problem...
  256.  o The default (program-coded) and standard (installed) layout preferences
  257.    open a PAL screen, 640x256. If you can't open a PAL screen however,
  258.    you will get an error message on startup; simply ignore this messages,
  259.    open on the system`s default public screen, change the layout preferences
  260.    in VideoMaxe to your wishes & "Save" it (see bug `-(13)').
  261.  o If you however see texts in VideoMaxe that begin with a "(*) ",
  262.    this indicates that in the catalog file you use this text had not
  263.    yet been translated into the language of the catalog in question.
  264.    This should not occur however.
  265.  o Some words to the catalog file and menu/gadget shortcuts.
  266.    There are some applications that strictly follow the style
  267.    guide: They define for every window everything new and use
  268.    the suggested names for the strings (i.e. XXX_MENU for
  269.    menus or XXX_GAD for gadget text). This is simply needed
  270.    if you want to define shortcuts for gadgets and menus in
  271.    the catalog, BUT:
  272.  
  273.    1st: you get monster names to differentiate the different
  274.         window names, i.e. like
  275.  
  276.         MSG_TRANSFERPANEL_ABORT_ENTIRE_TRANSFER_GAD_STR
  277.  
  278.         from Olaf Barthel`s Term.
  279.  
  280.    2nd: you get a damn lot of strings! E.g. Term`s source default
  281.         strings file is about 200 K big! As these default strings
  282.         must be hard-coded, that means 100 - 200 K more code
  283.         (depending on the compliler`s optimization) only for
  284.         the text!!
  285.         And think about all the translaters that have to
  286.         translate these strings...
  287.  
  288.    So, this is the reason why I will not define shortcuts via
  289.    the catalog file. I will even try 2 reduce the number of
  290.    needed strings by their intelligent combination.
  291.  
  292.  
  293. 1. Installation
  294. ================
  295.  
  296. 1.1. Requirements
  297. ------------------
  298.  
  299.  To be able to run (this version of) VideoMaxe on your computer you must
  300.  have any Amiga with OS 2.04+ and the locale library (available with
  301.  WB 2.1+).
  302.  
  303.  Remark: I tried to make the program runable without the locale library
  304.          to give users with WB 2.0 the chance to start the program.
  305.          Normally one can`t do that with M2Amiga (see bug `-(14)'),
  306.          but extra for new libraries since OS 36, they deliver optional
  307.          library interfaces. These can be imported without letting
  308.          the program assert if the library in question can`t be found,
  309.          but the programmer must test if it was really opened.
  310.          Great! I dedicated at least an hour to performing the
  311.          needed changes to realize the library as option, then finally
  312.          wanted to import the optional interface from my brand new
  313.          OS 39 distribution of M2Amiga, and --
  314.  
  315.                             IT WAS MISSING!!!!!!!!!
  316.  
  317. 1.2. Accomplish installation
  318. -----------------------------
  319.  
  320.  I recommend to use the multiple use installer script "InstallVM" in the
  321.  original archive; read its help texts for details.
  322.  
  323.  If you really want to do it by hand, read the `Documentation',
  324.  understand it and do it yourself; you may however - as the original
  325.  archive is runnable as it is - simply copy the whole directory to your
  326.  hard disk.
  327.  
  328.  
  329. 2. Documentation
  330. =================
  331.  
  332.  Please read the corresponding text file or klick on the corresponding
  333.  gadget if you are hypertexting. Note that for the latter the correct
  334.  file must be in the same directory as the this manual.
  335.  
  336.   Until now, the following languages are available:
  337.  
  338.  @{"English" link "Documentation_E.guide/main"} Text file: Documentation_E.txt
  339.  
  340.   Hoffentlich bald verfügbar:
  341.  @{"Deutsch" link "Documentation_D.guide/main"} Textdatei: Documentation_D.txt
  342.  
  343.  
  344. 3. History
  345. ===========
  346.  
  347.  This chapter consists of two parts, namely `Changes' and `Bugs'.
  348.  The first contains changes (improvements, additions, minor bugs)
  349.  made in newer releases.
  350.  The second part covers all major bugs found (and mostly solved)
  351.  in various releases of VideoMaxe. The only interesting part for
  352.  the user are the unsolved bugs there.
  353.  
  354. 3.1. Changes
  355. -------------
  356.  
  357.  Starting programming in 1989, releasing a first version openly
  358.  in 1990 (02.11). Starting here with the last 1.3 release.
  359.  
  360.  "Date" is always the final compilation date.
  361.  The more "o" are preceding the text, the more important is the change.
  362.  
  363. 3.1.1. Release 03.24
  364. ---------------------
  365.  
  366.  Date: 22 May 1992
  367.  
  368.  This is the last version of VideoMaxe for WB 1.3. Refer to the 03.24
  369.  documents for details.
  370.  
  371. 3.1.2. Release 04.00_beta
  372. --------------------------
  373.  
  374.  Date: 25 Feb 1993
  375.  
  376.  Initial 4.00 version. Had the remark not to use it as it was a
  377.  beta version and might be (and was...:.) bogus.
  378.  
  379.  Though successor of VideoMaxe 03.XX, so much changes have been
  380.  made that it is in fact a new program with completely new
  381.  documentation required.
  382.  
  383.  oo Added all the numberless fabulous features the 04 versions of
  384.    VideoMaxe!!!
  385.  oo All file formats changed. Opportunity to update project and
  386.    video recorder (old "Treiber"-) files.
  387.  
  388. 3.1.3. Version 04.10
  389. ---------------------
  390.  
  391.  Date: 16 Apr 1993
  392.  
  393.  Major bug fix release. First 04 release allowed to work with.
  394.  See `Bugs'.
  395.  
  396.  o Changed "VM:Prefs" to "VM:Config" (style guide)
  397.  
  398. 3.1.4. Version 04.11
  399. ---------------------
  400.  
  401.  Date: 26 Apr 1993
  402.  
  403.  Minor bug fix release. Done this mainly because of the embarrassing
  404.  bug `-(12)'.
  405.  
  406.  o some minor bug fixes
  407.  o you do not have to press "TAB" or "ENTER" to really read the
  408.    search texts in the search title and the search tape windows;
  409.    that was really irritating sometimes. Some gadget position
  410.    have changed as well...
  411.  o added french catalog. Thanks Leif!
  412.  
  413. 3.1.5. Version 04.12
  414. ---------------------
  415.  
  416.  Date: 06 May 1993
  417.  
  418.  Minor bug fix release, fixing bug `-(13)' that irritated some
  419.  american NTSC-only-machine users...
  420.  
  421.  o Improved the documentation
  422.  
  423. 3.1.6. Release 04.20
  424. ---------------------
  425.  
  426.  Date: 16 Sep 1993
  427.  
  428.  Major update release.
  429.  
  430.  o Finally found bug why program crashed when dragging a file onto
  431.    VideoMaxe's application icon. Now you`re able to drag project,
  432.    VideoMaxe preference and layout preference files onto VideoMaxe's
  433.    application icon in iconification mode.
  434.  o Comparing strings now with the localized compare from the locale
  435.    library (collate 2). No longer capitalize the title's strings
  436.    for exactly that reason.
  437.  o Won`t save icon now if there is already one existing when saving
  438.    a file. Saved icons will now have a no fixed icon position.
  439.  o Redrawed all VideoMaxe icons.
  440.  o Created in-program-code for the default layout window shapes.
  441.    This will let VideoMaxe`s default pal layout look much better
  442.    (try it in the layout preferences window, before all windows
  443.    were as big as the screen). Useful when the  "VM:Config/LO.prefs"
  444.    file however couldn`t be loaded.
  445.  oo Every project now contains a clipped title list, accessable in the
  446.    project window.
  447.  o Completed the documentation, writing my fingers down to rather
  448.    short sticks
  449.  oo Finally wrote an installer script. Will now do minor updates, new
  450.    installation, full version decoding, file updating
  451.  o No longer automatically capitalizing rubric names. This will
  452.    however not lead to compatibility problems, as these strings
  453.    were actually saved big and not only internally computed.
  454.  o Added shortcuts for important menus.
  455.  oo Put "Public screen?" and "Shanghai windows?" flags to work.
  456.  o Slight change needed in "Search for title" because of no longer
  457.    capitalizing title's key strings: "Search for full text" will now
  458.    regard case sense, only "Search for pattern" will not.
  459.    Embedded same behaviour into "Search for tape".
  460.  o new catalog file created (version 3). German updating, French updating
  461.    by Leif Kornstaedt (Thanks, Leif!).
  462.  oo Finally dropped the coded/light version schnick-schnack. Now you
  463.    can simply edit the password in the vm prefs, and according to its
  464.    correctness some features are blocked or not...
  465.  
  466. 3.1.7. Release 04.30
  467. ---------------------
  468.  
  469.  (Beta release)
  470.  
  471.  Date: 24 Nov 1993
  472.  
  473.  oo Severe intern structure change, discovering a number of
  474.    smaller bugs (producing some other smaller bugs... :+)
  475.  oo Re-thought VideoMaxe string output.
  476.    (1) New VIEW output for mask, rubric, tape, title, project.
  477.        Is shown in every id-output (e.g. lists).
  478.    (2) New INFO output for rubric, tape, title, project.
  479.        Info for rubric, tape, title in: project window.
  480.        Info for project in: project list window
  481.        Will provide prefs to handle what infos to display.
  482.    (3) For all these strings you now can adjust wether to take
  483.        texts or symbols (VideoMaxe prefs) as identification for
  484.        the shown values.
  485.    As for point (1), creating and showing lists will be somewhat
  486.    slower...
  487.  oo Introduced DYNAMIC STRINGS! That means that any string may be as
  488.    long as you like!!
  489.  oo Added mask special window. No fun these long menus...
  490.  oo Finally produced a statistics window worth its name.
  491.  o Will take own allocation procedures now, no longer the standard
  492.    M2Amiga ones. This & the new dynamic string feature leads to the
  493.    following run time memory improvements for a test VideoMaxe project
  494.    file with 209 Titles:
  495.  
  496.                            V4.20                        V4.30
  497.                                              (standard heap)        (own heap)
  498.    Memory needed        128.608                99.848                89.696        Bytes
  499.  
  500.  oo No more fussing about with TAB/ENTER to really read the data of
  501.    integer/string gadgets. Now the data always will be read from the
  502.    gadgets when required.
  503.  oo File formats have changed:
  504.    -Mask list files                    changed, update with vmconvert
  505.    -Project files                      changed, update with vmconvert
  506.    -Video recorder files               changed, update with vmconvert
  507.    -Printer preferences files          changed, update with vmconvert
  508.    -VideoMaxe preferences files        changed, can't be updated
  509.    -Layout preferences files           unchanged
  510.  o many smaller & bigger changes concerning the outfit of the windows
  511.  o improved window close up routine(s) due to halted window...
  512.  oo some oddities concerning the tab cycle feature for gadtool gadgets
  513.    removed (used to recalc some values & then redraw the gadget in
  514.    question, which caused the gadget to deactivate...). Now, the
  515.    redraw procedure will check the gadget for activation, the redraw
  516.    it and activates it again in case.
  517.  o VideoMaxe prefs. and its window changed to the new necessities.
  518.  o prt. prefs and its window  changed to the new necessities.
  519.  o spaces of time now in Hours, Minutes, Seconds.
  520.  
  521.  (proper release)
  522.  
  523.  Date: 13 Jan 1994
  524.  
  525.  o several beta bugs fixed.
  526.  o removed some harmeless bugs in some windows processings that forgot
  527.    to deallocate some data. Additionally, the deallocation procedure
  528.    will now be done with the window in question blocked until all
  529.    is deallocated, and then the window is closed. That clears up some
  530.    confusion that came up when the underlaying window was re-activated
  531.    though VideoMaxe was still working on the deallocation
  532.    (especially project window -> project list window).
  533.  o The standard gadget "OK" is now named "Use". That seems to tell more...
  534.  oo Implemented "next gadget activation" with [RETURN] (mainly because
  535.    some guy insisted the style guide says so...).
  536.  o Included Commodores 'Installer' & 'AmigaGuide' to the archive.
  537.  o added a _provisional_ 'Help' menu to project list window. However,
  538.    this will only execute the online help string of the VideoMaxe
  539.    preferences - please don't change that string as this somewhat
  540.    curious. As adjusted when VM comes, it will call:
  541.          run sys:utilities/AmigaGuide vm:docs/VideoMaxe.guide
  542.    The call will open VideoMaxe.guide asynchronosly. No guarantees
  543.    whether this will work on your installations are made...
  544.  oo Localized the installer script. English and German available.
  545.  o Project window: title list no longer recalculated after title search
  546.    (was rather senseless), no automatic flip to "all titles" mode after
  547.    inserting a new title (rather senseless, too). Active tape/rubric are
  548.    now taken as defaults for new titles.
  549.  oo Excluded limitations in serach title window for non-registered users.
  550.    Added an nerving requester for unregistered users.
  551.  oo Re-thought the 'search title' routine. Now no more odd results (due
  552.    to some unclarities whether to use the titles name or the modified
  553.    titles name (articles omitted) in search [binary search]).
  554.    Added "AddAllMatching..."-feature, suggested by Lothar Mai.
  555.  o Dyn. string max block size limited to 100 (range now {1..100}).
  556.  o Time space length: zero values are no longer shown. E.g.
  557.    "23 Minutes" instead of "0 Hours, 23 Minutes, 0 Seconds".
  558.    "0 Seconds"  instead of "0 Hours, 0 Minutes, 0 Seconds" (!!).
  559.  o Fixed bug: When printing, the VideoMaxe defaults for info text verbosity
  560.    were used (not those values of the printer config of the project
  561.    (respectively changed project's prt. conf.))...
  562.  o The project window will now initially display the 1st tape instead
  563.    of the full title list.
  564.  o Added pattern gadget to the file requesters, defaulting to "~(#?.info)".
  565.  
  566. 3.1.8. Release 04.33
  567. ---------------------
  568.  
  569.  Date: 01 May 1994
  570.  
  571.  o The title view strings are now entirely created when loading a project,
  572.    not everytime they are needed. This will cost some more loading time &
  573.    memory, but will enormeously improve the time to create the display title
  574.    lists in the project window (e.g. when changing the list type). This was
  575.    really embarassing sometimes, especially for me, running an old 68000
  576.    still....
  577.  o Project window wouldn't redisplay title list after a window size change.
  578.    Fixed.
  579.  oo Display status of the project window (active list, title, tape, rubric,
  580.    prt. config number) is now silently saved with a project, thus you will
  581.    always return to the situation when you left the window...
  582.    Clipped title list will be silently saved now, too -- not exactly the
  583.    _list_, but all titles of the list; its _order_ of titles may be different.
  584.    Suggested by Andre Scherin.
  585.  o Title window: tape & rubric will now be shown as view text - as it shold be.
  586.  o The width of the rubric & tape gadgets in the project & title window will
  587.    now be calculated relative to the window width - they no longer have a
  588.    constant width per font. Thus, you may make more text visible in these
  589.    gadgets by increasing the window width.
  590.  oo Added split & merge facilities for projects!!! See the "project list"'s
  591.    special menu.
  592.  o Print: Now you can adjust the start & ending when printing a list.
  593.    Requested by several users.
  594.  o Removed special check for correct catalog version. See `Odds & Ends'.
  595.  o Title editor: You can now calculate a new titles length by typing its
  596.    end counter position. Suggested by Lothar Mai.
  597.  oo The error, info, question and about windows are now easy system
  598.    requesters. Advantages: The windows look somewhat better, have always
  599.    the correct size to read the contents properly, less program code
  600.    is needed. As consequence, these window's shape is not saved anymore.
  601.  o Registered users won't see the 'About' window on startup any more.
  602.    Unregistered users will see the whole 'About' window now as nerving
  603.    requester instead of the small info window...
  604.  o Included two WB tool types:
  605.    - PUBSCREEN  - defines own public screen name
  606.    - DEFPROJECT - defines a default project to be loaded on startup
  607.  o The project spool information will now have impact on the spool info
  608.    display in the tape info window (as it should be...).
  609.  o New catalog version (6) needed. Updated the german catalog. French
  610.    catalog updated by Leif Kornstaedt. Thanks!
  611.  o Updated the docs, preparation for mult. languages:
  612.     Docs/Manual.txt           english VideoMaxe Manual with "changing"
  613.                               information.
  614.     Docs/Documentation_X.txt  VideoMaxe Documentation in language X. Its
  615.                               guide file will be used as online help file.
  616.    In the VideoMaxe prefs. you can now adjust that file name -- no real
  617.    online help yet, but with "Specials.Help" in the project list window
  618.    that file will tried to be started with "SYS:Utilities/AmigaGuide"...
  619.  o Improved the hard-coded layout default...& VideoMaxe default...
  620.  o You can now adjust the online help file - the program "sys:utilities/
  621.    amigaguide" will be executed with that file as argument when you select
  622.    "Help". STILL provisional!!
  623.  oo New data type MEMO added.
  624.  o Mask entry window: Improved data restorage when changing data type.
  625.  o Project window: will now redisplay tape/title info text after
  626.    "MaskSpecials".
  627.  o Added (telling!?) appendices for the release files:
  628.    PROJECTS             : pj
  629.    MASKLISTS            : ml
  630.    VIDEORECORDER        : vcr
  631.    PRINTER PREFERENCES  : prp
  632.    VIDEOMAXE PREFERENCES: vmp
  633.    LAYOUT PREFERENCES   : lop
  634.  o Fixed: tape/rubric wouldn't redisplay after search for title.
  635.  o Search for title window: all found title are shown now while we are
  636.    busy searching "all matching" titles...
  637.  
  638. 3.2. Bugs
  639. ----------
  640.  
  641.  This chapter covers all major bugs found in various releases of
  642.  VideoMaxe. The only interesting part for the user are the unsolved
  643.  bugs here.
  644.  
  645.  Bugs are found in programs in multiple ways; there are small bugs,
  646.  funny and ugly bugs, and, of course, there are bugs not even
  647.  Commodore knows where they came from.
  648.  
  649.  But now for something completely different:
  650.  
  651.  o The bugs listed beneath are KNOWN bugs only (well, what else...);
  652.    thus, that list is not complete in what way soever.
  653.  o Furthermore, it may be that even some known "bugs" do not occur in
  654.    the list. For one thing, they may be too "small" so that I decided
  655.    not to mention them (and there are many of these, mentioned as
  656.    "done minor bug fixes" in "Changes"). The other thing is that I might
  657.    not consider some "strange" behaviour as "bug", though other may do.
  658.  
  659.  And here's the list:
  660.  
  661.  Convention:
  662.  
  663.  +(<bugNo>)        = Bug number <bugNo> is not yet fixed
  664.  -(<bugNo>)        = Bug number <bugNo> is fixed in current version
  665.  
  666.  
  667. 3.2.1. -(1)
  668. ------------
  669.  
  670.  In version      : 04.00_beta (08.03.93)
  671.  Location        : Everywhere
  672.  Situation       : More than one window is open
  673.  Error           : The IDCMP-Port of the unactive window is not blocked
  674.  Ok since        : Release 04.10
  675.  Notes           : This isn`t really a "bug", I simply haven`t implemented
  676.                    that yet. So watch out if VideoMaxe does not react...
  677.  
  678.  
  679. 3.2.2. -(2)
  680. ------------
  681.  
  682.  In version      : 04.00_beta (08.03.93)
  683.  Location        : Reopening VideoMaxe (from iconification)
  684.  Situation       : Not enough free (chip) ram available
  685.  Error           : VideoMaxe will assert (so all previously loaded (and
  686.                    perhaps changed) projects will be lost)
  687.  Ok since        : Release 04.10
  688.  
  689.  
  690. 3.2.3. -(3)
  691. ------------
  692.  
  693.  In version      : 04.00_beta (08.03.93)
  694.  Location        : Save project
  695.  Situation       : A loaded project`s path+filename is longer than 80 chars
  696.                   and you select the menu item "Save"
  697.  Error           : The complete filename will be cut off and the project will
  698.                   be tried to save to that wrong name; this might cause
  699.                   an error (that`s the best case) or the project might be
  700.                   saved to that wrong name. This latter behaviour is _VERY_
  701.                   ugly, as it may overwrite (without further request) an
  702.                   already existing file that coincidentially has exactly
  703.                   this name...
  704.  Ok since        : Release 04.10
  705.  Notes           : Fortunately, the worst case situation described above is
  706.                   not very probable
  707.  
  708. 3.2.4. -(4)
  709. ------------
  710.  
  711.  In version      : 04.00_beta (08.03.93)
  712.  Location        : Project
  713.  Situation       : Use one of the special mask operations
  714.  Error           : VideoMaxe does not recognize the project to be changed
  715.  Ok since        : Release 04.10
  716.  
  717. 3.2.5. -(5)
  718. ------------
  719.  
  720.  In version      : 04.00_beta (08.03.93)
  721.  Location        : Project
  722.  Situation       : Change the active list via the mx-gadget while there
  723.                   is no active title
  724.  Error           : VideoMaxe will not refresh the spool information even
  725.                   if the selection of the new list provides an active title
  726.  Ok since        : Release 04.10
  727.  
  728. 3.2.6. -(6)
  729. ------------
  730.  
  731.  In version      : 04.00_beta (08.03.93)
  732.  Location        : Main
  733.  Situation       : Starting up VideoMaxe
  734.  Error           : First, the about information is shown and then the args
  735.                    are loaded; this should be the other way round
  736.  Ok since        : Release 04.10
  737.  
  738. 3.2.7. -(7)
  739. ------------
  740.  
  741.  In version      : 04.00_beta (08.03.93)
  742.  Location        : Copied Title
  743.  Situation       : The title window starts with the advice to to copy a
  744.                    title
  745.  Error           : ALL information is copied while it is very unuseful
  746.                    to copy the date information; it should have the value
  747.                    of the current time
  748.  Ok since        : Release 04.10
  749.  Notes           : I will add the pre-text "Copy of " to the name of the
  750.                    title as well (and will think about other values useful
  751.                    to copy or not)
  752.  
  753. 3.2.8. -(8)
  754. ------------
  755.  
  756.  In version      : 04.00_beta (08.03.93)
  757.  Location        : Everywhere
  758.  Situation       : Closing a window
  759.  Error           : In this situation VideoMaxe should get both the normal
  760.                    window sizes & the zoomed window sizes. Somehow this
  761.                    goes astray.
  762.  Ok since        : Release 04.10
  763.  
  764. 3.2.9. -(9)
  765. ------------
  766.  
  767.  In version      : 04.00_beta (08.03.93)
  768.  Location        : Everywhere
  769.  Situation       : Intuition`s window refresh (caused by window size change)
  770.  Error           : After this operation the window will refresh its frame
  771.                    each time the right mouse button is pressed
  772.  Ok since        : 04.20
  773.  Notes           : This can be _very_ annoying if you have more of those
  774.                   windows, as the refreshing steals your time. Obviously
  775.                   my refreshing procedure is innocent, so why is this???
  776.  
  777. 3.2.10. -(10)
  778. --------------
  779.  
  780.  In version      : 04.00_beta (08.03.93)
  781.  Location        : Everywhere
  782.  Situation       : You`ve choosed a proportional gadget font in the layout
  783.                    preferences
  784.  Error           : The gadget real time calculations will be (slightly) wrong
  785.  Ok since        : 04.33
  786.  
  787. 3.2.11. -(11)
  788. --------------
  789.  
  790.  In version      : 04.00_beta (08.03.93)
  791.  Location        : Project list -> Project
  792.  Situation       : Ram-Cloning a project
  793.  Error           : Titles are inserted in alphabetical order. As the titles
  794.                   are managed in a binary tree as well (and I haven`t
  795.                   implemented AVL-Trees...), the tree of the cloned project
  796.                   becomes a linear list. Employing the recursive search
  797.                   procs (and these are used in the copying routine itself)
  798.                   then very likely leads to a stack overflow error...
  799.  Ok since        : Release 04.10
  800.  Notes           : The titles are now inserted according to the tape title
  801.                   lists as it should be (and is handled saving projects).
  802.                   Thus, I hope to have the best chance to get an more or
  803.                   less balanced tree.
  804.  
  805. 3.2.12. -(12)
  806. --------------
  807.  
  808.  In version      : 04.10
  809.  Location        : Suggest
  810.  Situation       : Choosing a suggestion for used spaces that does fully
  811.                   overplay (at least one) title (indicated by only one
  812.                   ">")
  813.  Error           : VideoMaxe will Assert with an error message that can
  814.                   only be understood by me :+).
  815.  Ok since        : Release 04.11
  816.  Notes           : There were three words missing in the source after I
  817.                   had slightly changed the meaning of a datatype :-|.
  818.                   It was something like "AND (end <> NIL)"...
  819.  
  820. 3.2.13. -(13)
  821. --------------
  822.  
  823.  In version      : 04.11
  824.  Location        : Starting up VideoMaxe
  825.  Situation       : Can`t open the screen though enough memory available
  826.                   (e.g. because of an unexistent screen mode).
  827.  Error           : VideoMaxe will give the error message "Not enough
  828.                   memory available!" instead of "Can`t open screen!".
  829.                   Furthermore, VideoMaxe will not try to open a screen
  830.                   with another (available) screen mode.
  831.  Ok since        : Release 04.12
  832.  Notes           : Reported to me by Matt Simmons.
  833.                    In fact, you might get trouble if you want to START
  834.                    VideoMaxe of Releases 04.11- on a pure NTSC machine
  835.                    (though certainly the programs runs with any screen
  836.                    mode), as you can`t change the preloaded layout
  837.                    preferences file.
  838.  
  839. 3.2.14. -(14)
  840. --------------
  841.  
  842.  In version      : 04.00
  843.  Location        : Starting up VideoMaxe
  844.  Situation       : A library VideoMaxe needs is not available.
  845.  Error           : The program SHOULD assert with the dos exit code
  846.                    FAILED (but one should not believe an compilers
  847.                    manual...). The program DOES mostly assert with an
  848.                    ILLEGAL INSTRUCTION ALERT however.
  849.  Ok since        : Release 04.20
  850.  Notes           : As M2Amiga automatically opens the used libraries,
  851.                    I`ve no chance to explicitely test all needed
  852.                    libraries - the runtime system is doing that for
  853.                    me (with this noted bug...). _I_ can`t correct
  854.                    this but will now link a run time file that at
  855.                    least shows which library could not be opened (though
  856.                    code will thus increase).
  857.  
  858. 3.2.15. -(15)
  859. ----------------
  860.  
  861.  In version      : 04.12
  862.  Location        : Print routine
  863.  Situation       : Printing with certain printer drivers (e.g. EpsonX)
  864.  Error           : Printer device will produce an error when initializing
  865.                   the printer (though the used commands are known to the
  866.                   driver); this will let VideoMaxe cancel the print job.
  867.  Ok since        : Release 04.20
  868.  Notes           : Obviously no failure of my print routine. I did the
  869.                   following to improve VideoMaxe failure handling:
  870.  
  871.                   o survey the printer device error flag after every
  872.                     ANSI command sent to it and
  873.  
  874.                     + display any _known_ error as plain text with the
  875.                       last used ANSI command
  876.                     + display any unknown error with the last used ANSI
  877.                       command
  878.                     + let the user decide after any of those errors if
  879.                       he wants to cancel, proceed or proceed & ignore
  880.                       the following errors
  881.  
  882. 3.2.16. -(16)
  883. --------------
  884.  
  885.  In version      : 04.12
  886.  Location        : Startup
  887.  Situation       : Starting VideoMaxe up from Workbench with VM: not
  888.                    assigned.
  889.  Error           : VideoMaxe will not automatically assign VM: to the
  890.                    current directory.
  891.  Ok since        : Release  04.20
  892.  Notes           : Did look for the cli-structure only...
  893.  
  894. 3.2.17. -(17)
  895. --------------
  896.  
  897.  In version      : 04.10
  898.  Location        : Saving a project to a project file.
  899.  Situation       : Save (not "Save as") a NEW project.
  900.  Error           : Access to NIL: as no default file name present - program
  901.                    asserts
  902.  Ok since        : Release 04.20
  903.  Notes           : Never done this, discovered by chance!!
  904.                    Now ignoring such call.
  905.  
  906. 3.2.18. -(18)
  907. --------------
  908.  
  909.  In version      : 04.12
  910.  Location        : Startup VideoMaxe
  911.  Situation       : Supply a layout preferences file as argument
  912.  Error           : Won't open the correct screen
  913.  Ok since        : Release  04.20
  914.  Notes           : Simply corrected the order of the startup sequence.
  915.                    Rather foolish error...
  916.  
  917. 3.2.19. -(19)
  918. --------------
  919.  
  920.  In version      : 04.12
  921.  Location        : Delete a title
  922.  Situation       : U wanta delete a title with length zero
  923.  Error           : Won`t be able to do that if it is not last on tape.
  924.  Ok since        : Release  04.20
  925.  Notes           : Sure you should be able to delete a title with length
  926.                    zero any time. In fact, you could not delete such titles
  927.                    at all if they weren`t last on tape...now you can.
  928.  
  929. 3.2.20. -(20)
  930. --------------
  931.  
  932.  In version      : 04.12
  933.  Location        : Release package
  934.  Situation       : -
  935.  Error           : An absolutely senseless file "Install.bat" was included.
  936.  Ok since        : Release  04.20
  937.  Notes           : No idea how that file got there...
  938.  
  939. 3.2.21. -(21)
  940. --------------
  941.  
  942.  In version      : 04.00
  943.  Location        : Startup
  944.  Situation       : Old catalog loaded
  945.  Error           : String mixup
  946.  Ok since        : Release  04.20
  947.  Notes           : Delivered OC_Version with zero, because nothing else
  948.                    would work with OpenCatalog. A bug in M2Amiga?
  949.                    Now testing for version differently.
  950.  
  951. 3.2.22. -(22)
  952. --------------
  953.  
  954.  In version      : 04.20
  955.  Location        : Project window
  956.  Situation       : Leaving it via OK or DELETE
  957.  Error           : Exec list not deallocated => ram loss
  958.  Ok since        : Release  04.21
  959.  
  960. 3.2.23. -(23)
  961. --------------
  962.  
  963.  In version      : 04.20
  964.  Location        : Tape window
  965.  Situation       : Typing a 4-digit number into the length gadget
  966.  Error           : Integer overflow (Arts.Assert)
  967.  Ok since        : Release  04.30
  968.  
  969. 3.2.24. -(24)
  970. --------------
  971.  
  972.  In version      : 04.20
  973.  Location        : Leaving VideoMaxe
  974.  Situation       : The VideoMaxe screen is public & guest windows are open
  975.                    on it.
  976.  Error            (I leave that to your machine)
  977.  Ok since        : Release  04.30
  978.  Note            : Well, I simply forgot to change my Screen-CloseUp
  979.                    procedure when introducing public screen; the old
  980.                    Screen-CloseUp handled it like a custom screen and
  981.                    tried to close all windows on it...very embarassing...
  982.  
  983. 3.2.25. -(25)
  984. --------------
  985.  
  986.  In version      : 04.20
  987.  Location        : Title window
  988.  Situation       : Changing an existing title via OK (resp. USE) with:
  989.                    o the change won't be applyable due to any reason(s)
  990.                      (so an error _should_ occur...)
  991.                    o you have bad luck because some intern pointer is
  992.                      set this way and not the other...:-(
  993.  Error           : Stack overflow because of corrupt binary title tree may occur.
  994.  Ok since        : Release 04.30
  995.  Note            : If the above mentioned circumstances are matched (what
  996.                    is rather rare & thus kept me from recognizing this bug
  997.                     for so long..), the intern binary title tree will be
  998.                     corrupted. This *may* lead to a stack overflow because
  999.                     of an infinitive loop - but only if the corrupted part
  1000.                     of the tree is requested by the program.
  1001.                     So: Though this bug is rather rare & even if it occurs,
  1002.                     it mostly won't show -- I have found it. I am a hero.
  1003.  
  1004. 3.2.26. -(26)
  1005. --------------
  1006.  
  1007.  In version      : 04.30
  1008.  Location        : All menus
  1009.  Situation       : Running VideoMaxe under OS 3.0
  1010.  Error           : The Amiga Shortcuts are not present.
  1011.  Ok since        : 04.33
  1012.  Note            : Thanks to Christoph Feck for the hint.
  1013.  
  1014. 3.2.27. -(27)
  1015. --------------
  1016.  
  1017.  In version      : 04.30
  1018.  Location        : All cycle gadgets
  1019.  Situation       : Running VideoMaxe with a bigger CPU than 68000 (??)
  1020.  Error           : Text panic in the cycle gadgets.
  1021.  Ok since        : 04.33
  1022.  Note            : (I) THE BUG: The cycle gadgets were created with
  1023.  
  1024.                         ng.label = ADDRESS(CycleLabelAddressArray);
  1025.                         ng.flags = placetextIn;
  1026.  
  1027.                    which is certainly bogus as this will try to display the
  1028.                    string array as a text (!) and inside the cycle gadget (!).
  1029.  
  1030.                    (II) On my machine (A500, Kick 37.175, WB 38.36), everything
  1031.                    was fine - never saw anything but correct cycle gadgets as
  1032.                    I planned them.
  1033.  
  1034.                    (III) Reports said, that on machines with the same software
  1035.                    (Kick 37.175, WB 38.36) but running with better processors
  1036.                    (e.g. with a turbo-card), the bug DID occur. As for this point,
  1037.                    I did not think AT ALL of a bug like it actually was, but that
  1038.                    something with the text-addresses would go wrong using higher
  1039.                    processors. Thus, either the reports have been wrong, or we are
  1040.                    confronting another miracle in the world of computing...
  1041.  
  1042.                    (IV) A hint by Andreas Raquel guided me to the bug. Thanks!
  1043.  
  1044. 3.2.28. -(28)
  1045. --------------
  1046.  
  1047.  In version      : 04.30
  1048.  Location        : Layout preferences window
  1049.  Situation       : Loading a preferences file from disk, then try to choose
  1050.                    a font.
  1051.  Error           : The GURU might make a little visit, due to corrupt font name
  1052.                    addresses :-(.
  1053.  Ok since        : 04.33
  1054.  
  1055.  
  1056.  
  1057. 4. Thanks to...
  1058. ================
  1059.  
  1060.  Jens Stumpe for painting the title picture.
  1061.  Leif Tobias Kornstaedt for the French translation.
  1062.  
  1063.  All registered users!
  1064.  
  1065.  All programmers for their PD/Share-programmes that makes my Amiga worth
  1066.  living!!
  1067.  
  1068.  
  1069. 5. The Author
  1070. ==============
  1071.  
  1072.  The author is me and I am the author.
  1073.  
  1074.  
  1075.       |-----------------------------------------------------------|
  1076.       |          ADDRESS                                          |
  1077.       |···························································|
  1078.       |          Stephan Sürken                                   |
  1079.       |          Kurt-Schumacher-Str. 34 A 161                    |
  1080.       |          D-67663 Kaiserslautern                           |
  1081.       |-----------------------------------------------------------|
  1082.  
  1083.       |-----------------------------------------------------------|
  1084.       |          E-MAIL (InterNet)                                |
  1085.       |···························································|
  1086.       |          s_suerke@informatik.uni-kl.de                    |
  1087.       |-----------------------------------------------------------|
  1088.  
  1089.       |-----------------------------------------------------------|
  1090.       |          BANK ACCOUNT                                     |
  1091.       |···························································|
  1092.       |          o Stadtsparkasse Kaiserslautern, FRG             |
  1093.       |          o Bankleitzahl (BLZ)         : 540 501 10        |
  1094.       |          - Bildschirmtext (BTX)       : *966750#          |
  1095.       |          - SWIFT-Code                 : KLTS DE 55 BiC    |
  1096.       |          o Account-Number/Konto-Nummer: 128 029 758       |
  1097.       |-----------------------------------------------------------|
  1098.  
  1099.  
  1100.  For URGENT questions call D-0631-15045.
  1101.  
  1102.  Enjoy!
  1103.  
  1104.  -Stephan
  1105.